home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util2 / mkick19.lha / MKick.doc < prev    next >
Text File  |  1995-01-01  |  15KB  |  304 lines
  1. ==============================================================================
  2.  
  3.                                   MKick 1.9
  4.  
  5.                      (c) 1992-1995 MJSoft System Software
  6.  
  7.                                  Martin Mares
  8.  
  9. ==============================================================================
  10.  
  11.  
  12. Introduction and Copyright:
  13. ---------------------------
  14.  
  15.    See README. It contains a lot of things worth of being known.
  16.  
  17.  
  18. MKick usage:
  19. ------------
  20.  
  21.    MKick may be called either from the CLI or from the Workbench.
  22.  
  23.  
  24. Invocation from the CLI
  25. -----------------------
  26.  
  27.    Syntax: MKick [<Kickstart>] [<memory options>] [<other options>]
  28.                  [<debug options>]
  29.  
  30. Kickstart specification:
  31.  
  32.    These parameters specify which Kickstart do you want to use:
  33.  
  34.        <name> - install Kickstart specified by its name
  35.           GUI - show GUI allowing to select the Kickstart and some basic
  36.                 options by the mouse (or the rat if you have one :-)
  37.           ROM - go back to ROM Kickstart
  38.  
  39. Memory options:
  40.  
  41.    These options control the place you want to store the Kickstart on:
  42.  
  43.         NOREL - load Kickstart to its original memory location. Used automati-
  44.                 cally when you have no relocation table for the Kickstart.
  45.                 But only few Kickstarts are on such locations where you have
  46.                 some RAM. (Many Kickstarts are stored in standard ROM memory
  47.                 (at F80000 and higher). Only the beta-ROMs are located at
  48.                 200000 (standard expansion memory) sometimes.)
  49.  
  50. ADR <address> - load Kickstart at specified address. It's used mostly for
  51.                 debugging or when kicking to RAM placed on unusual location.
  52.                 The address is specified in hexadecimal (base-16) notation.
  53.                 All addresses of type 00xx0000 (xx is any number) can be
  54.                 written in short form: xx (this is the notation introduced
  55.                 in SKick). The Kickstart address must be a multiple of 64K
  56.                 (the last four digits _MUST_ be 0) and mustn't be less than
  57.                 40000.
  58.  
  59. CHIP,FAST,EXP,NAC - load Kickstart to CHIP/FAST/EXPANSION/NON-AUTOCONFIG MEMORY.
  60.                 These options may be combined (you can say MKick kick34005.a500
  61.                 CHIP FAST) and MKick will automatically select the best possible
  62.                 location. (The standard order is NAC/EXP/FAST/CHIP, from top
  63.                 to bottom. It is based on standard priority scheme used by Exec.
  64.                 See also ADDMEM.) These options affect memory types offered
  65.                 by the GUI.
  66.  
  67.     <nothing> - When you specify no memory control options, MKick will assume
  68.                 that CHIP, FAST, EXP and NAC options are set.
  69.  
  70. ADDMEM <base>,<size>[,<priority>] - add a region of NON-AUTOCONFIG RAM to the
  71.                 system. The non-autoconfig (NAC) RAM can be found on many
  72.                 accelerated systems. The basic property of this type of memory
  73.                 is that it's present when the machine is rebooted, but no part
  74.                 of the operating system is able to find it and give it to all
  75.                 application programs. The manufacturers usually supply some
  76.                 utility which is able to do the memory adding for you, but these
  77.                 utilities have significant problems with the most of kickers.
  78.                 In this case, you can simply say MKick where is your memory
  79.                 located, how large is it (specified in bytes; both the address
  80.                 and the size are hexadecimal numbers; the shortened form used
  81.                 by ADR can be used here, too). The priority is a decimal number
  82.                 in range <-128;127>. All regions of available memory are sorted
  83.                 by their priority (expansion memory has 10, fast RAM 0, chip RAM
  84.                 -10, default for ADDMEM is 20). When a program tries to allocate
  85.                 some memory, the Exec will use available memory chunk with the
  86.                 highest priority it founds and because the NAC RAM is often the
  87.                 fastest one in the system, it's very good to use it first.
  88.  
  89. SUBMEM <base>,<size> - remove given memory region. Used rarely on some special
  90.     configurations. A typical example is GVP A530 Turbo with 5MB
  91.     of RAM (one 4M SIMM and one 1M with switches set to 4M+4M).
  92.     In this case, 8M address space is created contining the 4M SIMM
  93.     followed by the 1M SIMM mirrored four times. For correct opera-
  94.     tion in such a case you need to SUBMEM three of the mirrors
  95.     to prevent the system from using them (by SUBMEM 700000,300000).
  96.     If you specify both ADDMEM and SUBMEM, ADDMEM is processed
  97.     first.
  98.  
  99. Other options:
  100.  
  101.          AUTO - exit if already kicked. The operation you have selected won't be
  102.                 done if there is already some Kickstart in RAM or if you sele-
  103.                 cted (by the ROM option or by the GUI) that you want to use ROM
  104.                 Kickstart. For example: if you have MKick in your startup-sequence
  105.                 and you want to start KS 3.0 when you boot first time, you can
  106.                 say 'MKick DEVS:Kickstarts/Kick39106.A1200 AUTO' in this case.
  107.                 It will prevent MKick from trying to re-kick whenever you boot
  108.                 and will allow you to stay in ROM KS without changing anything.
  109.                 you can also say 'MKick AUTO GUI' - it displays GUI only when
  110.                 you didn't select any Kickstart before.
  111.  
  112.        NOTAGS - remove all resident modules before kicking. MKick tries to use
  113.                 smart algorithm of removing of modules, which could cause system
  114.                 crash, but there could be an exception that isn't capable of
  115.                 being handled by this way. If MKick doesn't work on your system,
  116.                 try to use this option.
  117.  
  118.       NOPATCH - don't use the patches. The patch tables are usually built to
  119.                 fix known Kickstart bugs. Some of these bugs can cause wrong
  120.                 operation of kickers. Don't use this option when you don't know
  121.                 what are you really doing.
  122.  
  123.   KICKDIR <x> - search for Kickstarts in specified directory. The default is
  124.                 "DEVS:Kickstarts". It affects only the GUI.
  125.  
  126.         CACHE - turn on CPU caches as soon as it's possible. The machines
  127.                 equipped with 68020 or higher CPU have a CACHE MEMORY. When
  128.                 it's used, it speeds up a bit all operations, but not all
  129.                 programs are compatible with this CPU enhancement. The caches
  130.                 are normally switched on by CPU, SETCPU or other similar
  131.                 command, which can be started from the startup-sequence.
  132.                 If you want to enable the caches automatically, you should
  133.                 specify this option.
  134.  
  135.         EBREL - relocate ExecBase to expansion or non-autoconfig memory. It
  136.                 can slightly increase system performance. This feature is
  137.                 somewhat tricky and works only with some Kickstarts (Kickstarts
  138.                 older than 2.04 and most of A600 versions don't allow it).
  139.                 As Kickstarts 1.X require ExecBase to be present when
  140.                 the system starts, systems with ExecBase in expansion memory
  141.                 cannot survive standard reboot (with ExecBase in non-autoconfig
  142.                 memory it's usually possible). MKick's own resets (when
  143.                 switching to another Kickstart) create fake ExecBase in chip
  144.                 RAM allowing it to survive. Also the ColdReboot system call is
  145.                 patched, so you can use it for rebooting without losing the
  146.                 Kickstart.
  147.  
  148.                    There exists a FastEBPatch utility (distributed in this
  149.                 archive), which patches some other system calls and creates
  150.                 a Ctrl-Alt-Alt-Del sequence for resetting the machine in
  151.                 a clean way.
  152.  
  153.        RELVEC - relocate CPU vectors (normally placed on addresses 8-$3FF) to
  154.                 fast RAM (applicable only with 68010 or newer CPU installed).
  155.                 Can slightly increase system performance and reduce amount of
  156.                 deadly system crashes (the probability that unwanted memory
  157.                 access caused by a crash hits the vectors is a bit lower).
  158.  
  159.                    In this mode, space for new vector table is allocated, the
  160.                 vectors are moved into it and the VBR register is set to the new
  161.                 address. The original vector area is cleared, only the longword
  162.                 at address $8 points to the new vectors (this rule has been
  163.                 introduced by SinSoft to be used in some products which require
  164.                 exact knowledge of vector base without switching to supervisor
  165.                 mode (e.g., if the ExecBase is inaccessible). The deadend alerts
  166.                 don't work in this mode unless the FastEBPatch is installed.
  167.  
  168. Debug options:
  169.  
  170.          WAIT - wait for RETURN key before resetting the machine. If you enter
  171.                 'q', MKick will stop the action and exit immediately without
  172.                 deallocating any memory, therefore you can look at MKick's
  173.                 resident module and similar things. If you see that something
  174.                 is wrong, you can press CTRL-C (MKick checks CTRL-C before it
  175.                 installs the resident tags and before each reboot). In this
  176.                 case, MKick deallocates all used memory and terminates. The
  177.                 checking of CTRL-C doesn't depend on WAITing.
  178.  
  179.         DEBUG - turn on debugging information. It consists of two sequences
  180.                 of colourful stripes displayed during reboot with RAM KS.
  181.                 The first set of stripes (all colours) is displayed before
  182.                 the RAM KS is started. The second (black & white) one is
  183.                 displayed when MKick fixes RAM, adds autoconfig devices
  184.                 and does many other things. During the second phase, if you
  185.                 hold the left mouse button and you have KS V36 or higher, the
  186.                 startup-sequence will be disabled (the mouse button is tested
  187.                 immediately after the black & white stripes appear). Please
  188.                 include effect of this option if you are preparing a bug
  189.                 report for me. Warning: pressing of LMB during the first phase
  190.                 has different effect - removing of all resident modules.
  191.  
  192.        NOTEST - don't test Kickstart image before using it. Don't use, because
  193.                 invalid Kickstart images don't work properly.
  194.  
  195.         FORCE - don't fail if Kickstart memory can't be allocated. Used rarely,
  196.                 but if you have some non-autoconfig memory at $600000 and you
  197.                 don't want to use ADDMEM and the memory is not added to the
  198.                 system, you should enter 'MKick <Kickstart name> ADR 60 FORCE'.
  199.  
  200.  
  201. Invocation from Workbench:
  202. --------------------------
  203.  
  204.    Simply double-click on MKick's icon and MKick will be started.  Using
  205. 'Info' or 'Information' (WB 2.0 or higher), you may specify all previously
  206. mentioned options using the tool types.  The boolean (ON/OFF) switches can be
  207. enabled using their name followed by '=' or '=ON'.  If the Kickstart name
  208. (FILE=) is not specified, the GUI is started automatically.
  209.  
  210.  
  211. Graphic User Interface:
  212. -----------------------
  213.  
  214.    When MKick is started in the GUI mode, a screen with a list of available
  215. Kickstarts will appear.  You may select the Kickstart you want to use or hit
  216. 'Cancel'.
  217.  
  218.    Then you may select the type of RAM you want to store the Kickstart to
  219. (ORIGINAL location, CHIP RAM, FAST RAM, EXP RAM, NAC RAM or ANY RAM if you
  220. want to choose the optimal location automatically).  It's also possible to
  221. disable the patches.  Then hit the 'OK' gadget to start the whole loading
  222. process.
  223.  
  224.  
  225. Types of operation:
  226. -------------------
  227.  
  228.  - Normal loading - used when you load the Kickstart to memory which is free
  229.  
  230.  - Loading to temporary buffer - used when you want to load the Kickstart to
  231. memory which is not free, but if there is some room to load the image to.
  232.  
  233.  - Hard loading - used if the FORCE option has been specified. In this case,
  234. the RAM block containing the Kickstart image will be allocated only if it's
  235. possible. Unsuccessful allocation will not be reported.
  236.  
  237.  - Disconnecting of C0-RAM - used if you have only 0.5M of CHIP RAM and 0.5M
  238. of FAST RAM.  MKick will perform a reset to disconnect the FAST RAM from the
  239. system memory list.  Then (if started again) it will load the Kickstart to the
  240. disconnected C0-RAM.
  241.  
  242.  - Loading from Kickstart disk - MKick allows to load the Kickstart from the
  243. floppy. It supports original SuperKickstart disks for the A3000 and the
  244. specially formatted disks created by MakeKickDisk.
  245.  
  246.  - Removing of RAM Kickstart - uses reset
  247.  
  248.  - Replacing RAM Kickstart by another RAM Kickstart - uses reset to remove the
  249. old one and then (if started again, normally from the Startup-sequence) tries
  250. to load the Kickstart using one of previously mentioned methods.
  251.  
  252.  
  253. Common problems:
  254. ----------------
  255.  
  256.  - MKick has no effect - normal reboot happens: Some resident modules collide
  257. with MKick. MKick normally tries to remove such modules, but ... you can fix
  258. it by using of the NOTAGS option or by removing the module manually.
  259.  
  260.  - Colourful stripes move on the screen and the machine seems to be crashed:
  261. It occurs when MKick isn't able to allocate the Kickstart block memory. Try
  262. the operation again after a cold reboot.
  263.  
  264.  - Black and white stripes and the machine seems to be crashed: Kickstart image
  265. checksum error during AUTOSUM test. Some program has destroyed the Kickstart.
  266. Use MKick again.
  267.  
  268.  - Black and white stripes, which disappear if you press the left mouse button:
  269. MKick is unable to allocate space for some resident module. This should not
  270. happen, but when it happens, it can be fixed if you select the NOTAGS switch.
  271.  
  272.  - Quickly blinking power led with red color of screen background: Kickstart
  273. image checksum doesn't match. Some program has destroyed the Kickstart. Use
  274. MKick again.
  275.  
  276.  - "Incorrect or suspicious Kickstart file" message: the Kickstart file you
  277. have supplied is corrupted or encrypted. The only thing you can do with
  278. corrupted Kickstart files is to throw them out. The encrypted files can be
  279. decrypted using the MakeKick utility (see the KICKTO option of MakeKick).
  280.  
  281.  - "Incorrect Kickstart address in header file","Invalid Kickstart original
  282. address","Corrupted Kickstart file","Kickstart file doesn't match the header",
  283. "Error reading Kickstart file" and other similar messages: The Kickstart file
  284. you have supplied doesn't match the Kickstart header. Your Kickstart can be
  285. corrupted or patched, but there's also a possibility that you have choosed
  286. wrong name of the Kickstart.
  287.  
  288.   - MKick can crash if you use some ROM remapping utility.
  289.  
  290.  
  291. Removing of resident modules:
  292. -----------------------------
  293.  
  294.    In several situations, you might want to remove all resident modules
  295. which survive reset (such as RAD, NewAlertHook etc. - especially useful
  296. if debugging such a thing). MKick can help you: If you hold the left mouse
  297. button during system reboot (after initialization of ROM Kickstart, but before
  298. start of the one in RAM), the resident modules except MKick's own module are
  299. removed.
  300.  
  301.    Warning: If you want to invoke bootmenu, you must press the buttons
  302. after the RAM Kickstart is started to avoid the actions described above.
  303.  
  304.